










JANUARY 1977 


ATTENTION!! ATTENTION! . 


We've moved - here'e the new address for all correspondence and subscriptions: 


KIN-2 USER NOTES : L 
c/o Bric C. Retake 

425 Weadow Lane . 
Seven Mills, Ohio 44132 Phane = 216-524-7261 . 


KDt-1 USER NOTES is published every 5 to 8 weeks. The suoscription rate for U.S. and Can- 
adiaa subscribers is 65.00 for ieeves 1 thru 6 including lst class postage. Fcreign subscrip- 
tions = $8.00 icluding lst class air mail postage. 


Payemt should be mde in U.S. funds with a check or money order (no cash or purchase or= 
dere) please. 


fo alleviate possible typographical errors, please try to subait articles is 
glee 4 —— @m white bond eo that we may cut and paste instead of re-typing. Also, if 


you expest ena expe to correspondence, please include a self addressed stamped en- 
velope, to fray expences. 
eeeesecsoes . t 


Sere is a enseyetims: for teen". - Stan Ockere dinfirwsd mo that, Sage 0’ sakrean GNM shocid ut 
be a9 (not 49}. 


sovescocces i 


Hope you all hed a he ppy holiday and that your happy new year will last through 19771 


SUN pure bed 2 happy new year! Two national amatuer radio segs had application articles $ 
mu EDM dn their Jen. '77 iseurol Magazine showed how KIM could be set up to be a Morse 
Oote Kaytoard. (9-1000 WH) «ith the additioa of an ASCII keyboard and a few discrete com 
peneate. ‘ 





I bed my morse keyboard up and runing the very next day vith s Sanders 720 keyboard and 
the reed relay amd trenaistor driver from what I had laying around the shack, Boy, wat en 
exciting feeling to just press typewriter keys and have perfect CW going out on the air! I 
really eajey rag chewing (bem lingo for chewing the fat) and the Morse keyboard makes it al- ° 
most effortlees. ‘The first fellow I had a Q60 (contact) with bed to listen to about 10 solid 
minutes of C¥ (morse enge) because once I got started hacking away st the keys, I just couldn't 
stop! The great advantage of the software approach to implementing a moree-code keyboard really 

Wy 
a. 





becomes apparent when you want to add fuctions or otherwise change ite operation, 

Que of our members, Carl M. Robbins WAJTH, wrote the article oa controlling a 2-meter re- 
ter with KIN which appeared in the Jan '77 issue of 9ST Magasin». Complete schematics on 
KIM interfaces and fall tpttwere listings are provided, which make this seem like the best way - 
to go if you are ecettingya repeater and wat to go the microprocessor route! 


i 


Got a letter from Elict Friedman KOWR, 1175 Wendy Rd., Ann Arbor, Michigan 48103, Eliot * | 
is interested in contacting other radio amateur KIM owmera and perhaps forming a net where in- - 
formation and programs could be exchanged. 


seeeeeceeee 





Some further comments on the Byte Shop #2 Tiny Basic tapes frog Bob Grater: These cas—- 
eatte tapes are set up to rum in KIN with 4K of memory added from O+00-13FF. If you wat Tiny | 
Mesic for the area above the KIM Monitor (address 2000 on up) then you will have to get the : 
paper tape version which costs $7.50 and includes the manual. The cassette version rms $9.50. - 
Include $1.00 shipping on either of these items. 


e-\ 


FROM THE FACTORY: Problems with some 6552 ch:ze. ( 


T have been informed of two possible problem areas witt t:.e £502 CPU. Some of the early 
CPU's didn't set the zero flag correctly after register tc register transfers,(TAY, TAX,TYA ete 
This would make it impossible to run Tiny Basic, All 652 CrUgcculd have problems setting the 
zero flag after decimal addition when the answer equalled zero. Test your CPU with a siaple 
program to see if you have thi problems. The decimal addition problem can be gotten around 
by an "OR" immediate with "OO" after the operation which would then set the zero flag correctly 
The only method of solving the register transfer not setting zero flag would be to install a 
new CPU. (You would then pick up the "ROR" rotate right instruction in the process). 


Copying KIM cassette tapes: 


If you've tried copying KIM tapes from ci tte to cassette then you already know that 
the copies will not be read correctly by KIM. The fix? Simply tie a .02 uf capacitor to 
ground from the junction of R6 and R34, Now make the new master tape. Copies from this new 
master should be read correctly by KIM, 


KIM-2 Memory expansion: 


If you wish your KIM-2 (4K) memory module to reside in the 0400-13FF position already 
decoded by KIM, then read on; Wire - or the KIM K1, K2, K3, K4 decoder outputs together, add 
a 3.3K pull-up resistor to +5 volts and tie these four lines to the address line 12 input on 
the KIM-2, set all the on-board DIP switches to the "off" position, and you're all set! 














INTRODUCTION TO KIM-1 ARCHITECTURE J. Butterfield 
14 Brooklyn Avenue 
Toronto M4M. 2x5 
Canada 


This is intended to be a beginner's guide to 

the way KIM-1 is put together. It's mostly a 
4 hardware description with (hopefully) explanatory 
notes. 


Because every KIM-1 owner has three fat manuals on 
his system, complete with detailed drawings, I'll 
try to save space here by referring to these manuals 
wherever possible. 


The Address and Data Busses. 

Le start with page 24 of the KIM-1 User Manual 
(KIM-1 Block Diagram, Figure 3.1). We're going to 
concentrate on those two pipes on the left: the 
Address and Data Busses. 


Every microsecond, the 6502 microprocessor sends out 

an address over the sixteen lines of the address bus. 
Sixteen lines are enough to address any of the 65,536 
memory locations that could be fitted to KIM-1 

(you only have 3,328 active addresses in the basic unit). 
In addition, there are a couple of other lines that 
accompany this bus: a Read/Write line (R/W) to tell 

i whether the microprocessor wants to read or write memorys 

i and a timing line, g2 (phi, pronounced fy, two; it's 
confusing on the diagram because the phi looks like a sero). 


The address bus goes to all memories. The idea is 
that when an address is generated, one memory only 
(whether RAM, ROM, I/O or Timer) suddenly says, 
‘that's mel’ and connects to the data bus. 

If the R/W line says, 'read', the memory concerned 
Places its data onto the bus; if ‘write’, the 

memory takes the data from the bus (placed there by 
the microprocessor) and stores it. For every address, 
only one memory unit responds; the rest stay silent. 


This points out a fundamental difference between the 
address and data busses. The address bus goes one way 
only: from the processor to the memory. But the data 
bus information flows both ways. 


This calls for a special kind of circuitry to connect 
to the data bus, called ‘tri-state’. Every device on 
the bus might be (1) sending: (2) receiving; or, 
| (3) ignoring the bus. (That isn't exactly how tri-state 
! is defined, but it's a good way to remember it). 
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Since ad 38 bus signals go one way only, it doesn't 
need to tri-state circuitry, which simplifies things. 
However, it could cause you minor problems if you wanted 
to expand your KIM-1 system so as to have two processors 
sharing the same memory, or if you wanted to drive 

a TV display directly from memory. In cases like that, 
the problem is called DMA (Direct Memory Access) and hints 
on how to solve it can be found on page 112 of the 
Hardware Manual. 


Turning to page 25 of the KIM-1 User Manual, we can see 
the Address and Data busses in a little more detail. 

A little closer examination turns up a problem: 

the whole address bus doesn't connect to the memory 
modules. In fact, only 10 bits (numbered ABO to AB9) 
out of the 16 are connected. That's enly enough to 
define 1,024 addresses. How can it work? 


Well, buried in the control logic block at the upper right 
is an ‘address decoder’. Although figure 3.2 doesn't show 
the connections, this circuit is looking at address bus 
lines AB10, AB1i1, and AB12. Depending on what it sees 

in this part of the address, it may fire up either 

of the ROMs (via leads K6 and K7), or the Timer/I0/RAM 
section of the 6530's (via lead K5), or the 1K RAM 

(via lead KO). Each memory unit will work only if its 
respective K lead is energized. So now, each unit is 
responding to 10+3 or 13 bits of address information. 


The address decoder, incidentally, can be seen in more 
detail on the next page, Figure 3.3, Control and Timing. 
It's block U4; you can see the three lines of the address 
bus coming in from the left, and the select signals 

(KO through K7) going out at the bottom. Incidentally, 
outputs K1 through K4 are not used on the basic KIM-11 
but they are available to you for expansion purposes. 
Each lead is capable on controlling 1K (1,024) bytes 

of memory. 


What about the other three bits of the address bus, 
AB13, AB14, and AB15? KIM-1 ignores'them. They are 
not needed for the basic system, so they're not used. 


This leads to an odd feature of the basic KIM-1 system. 
Since the three high-order bits of the address are ignored, 
the memory starts repeating itself after reaching 1FFF hex. 
For example, try storing something in address, say, 0123; 
then look at the contents of 2123, and 4123, etc. They're 
all the same location! 


This explains something that can be quite troublesome 
to the beginner. Both the Hardware Manual (page 40) 
and the Programming Manual (chapter 9, pages 124-146) 
state that the interrupt and rese* vectors are located 
at hexadecimal addresses FFFA to FFFF. Yet reading 
the KIM-1 Monitor program listings shows them to be 

at 1FFA to 1FFF. Very puzzling--until you realize that 
in the basic KIM, they are the same locations! 


It also outlines something you'll need to take into 
account when you add memory. If you use the 4K 
decoded for expansion with lines ¥1 to K4, no special 
reconfiguration is necessary ... you're staying in 

the area where the ‘duplicated’ addresses won't bother 
you. But to §° to addresses at hex 2000 and higher, 
read Chapter of the KIM-1 User Manual very carefully. 


Interrupts, Reset, and the SST 


The 6502 has three pins which force it to branch to a 

given location. They are called RST (reset), NMI (non-maskable 
interrupt), and IRQ (interrupt request). They all differ 

in detail, but the manner in which they cause a branch or 

jump in program execution is similar; we'll discuss them 
together. 

First: when the appropriate input pin is 'kicked', the 
microprocessor hardware, after doing a couple of odd jobs, 

digs out the address that it will jump to from a fixed 

location. This location varies depending on which pin 

was activated, but it will be in the range FFFA to FFFF 3 
hexadecimal (see page 146 of the Programming Manual). : 


Next step: because of the way the KIM-1 addressing is 
wired, you may recall that address FPFA is the same as ( 
address 1FFA. This is part of ROM (the 6530-002 chip), 
so that the contents of these vectors are fixed. 

They point at programs to handle each activity. 


Let's summarize what we have so far in a table: 


Pin Address of Vector Contents What you'll find at the 
Hardware KIM-1 vector location 


NMI FFFA-FFFB 1FFA-1FFB 1C1C Program NMIT (Jump indirect) 
RST FFFC-FFFD 1FFC-1FFD 1C22 Prgm RST (A reset program) 
IRQ FFFE-FFFF 1FFE-1FFF 1C1F Program IRQT (Jump indirect) 


So the branches we take are completely predefined for us 
by the Monitor program. In the case of Reset, the 
system will reset the stack pointer and then proceed 

to the main monitor program. 


But the other two are different. Programs NMIT and IRQT, 
to which the two respective vectors point, are nothing more 
than indirect jumps. And the address to which you will 
jump, in both cases, is stored in RAM; so you can change 
these addresses to make the two interrupts branch anywhere 
you want. (Normally, you'll want the address of monitor 
program SAVE, at 1C00,stored in both vectors). 


So there are two kinds of vectors: the hardware vectors 
at 1FPA to 1FFF witich you can't touch since they are in ROMs 
and the software vectors at 17FA to 17FF which you must 
set up cach tims you turn on the system. (Oddly enough, 
the software vectors include a Reset vector that isn't used). 


It's good practice, every time you power up, to key ins 


setting the vectors and thus enabling the ST key and SST switch. 


Now let's take a little excursion into software. 

When you push the GO button (or hit the G key if you're 
lucky enough to have teletype), the Monitor does a few 

last things before it gives up control to your program. 
Refer to page 39 of the KIM User Manual (Special Memory 
Addresses). You'll see that locations OOF1 to OOF5 

are associated with various registers of the microprocessor. 


When you push the GO button, the Monitor digs out these 
locations and puts them in the microprocessor registers. 
(You can read the program that does it at locations 
1DC8 to 1E87 - it's quite clever). 


This means something quite important to the programmer 
who's doing testing. You can set the initial values 
of any of the registers before you run - by storing the 
appropriate values in F1 to F5. 


Note that the Monitor does all this. As far as the micro- 
processor is concerned, these locations have no special 
status; they are no different from any other part of 
memory. If a program puts something in the accumulator, 
the contents of F3 don't change, and vice versa. 


Now, we've talked about what happens when your program 
starts. What happens when it stops? It would be handy 
(for debugging and other reasons) if the registers could 
be dumped out to the same locations (F1 to F5). 


Well, program SAVE at location 1C00 does exactly that. 
So if possible, we should try to terminate a program by 
having it exit to location SAVE. Here are several ways 
of doing it: 


1. Finish your program with the instruction JSR SAVE1 
(20 05 1C). The accumulator will be lost, but the 
other registers will be saved correctly. 


2. Finish your program with a BRK (00) instruction, and 


be sure your software vector at 17FE-17FF set to 
the address of SAVE (1C00). 


3. To stop your program while it is running, press the 


ST button; but be sure you have previously set the 
software vector at 17FA-17FB to the address of SAVE 


oA 


4, If you have. t the SST switch to on, the program 
will stop df y-one instruction -- provided you have 


set the sof. .ce vector at 17FA-17FB to address SAVE. ne a ene 
More about how this happens soon. S3ara 2 
ate 
How does the SST switch do that, anyway? Let's return gsxr eds 
to the hardware. , ye as 33 23 
The diagram on page 26 of the KIM User Manual (Control and 3- 2 Se 
Timing) contains the basic information, especially in the gSour 
area of U26 (a NAND gate). Saza8 * 
¢ 
We can see that the SST switch, when operated, will kick pokes bd 
the NMI interrupt pin when the following two conditions “3 eT2 
are satisfied: gaaa > 
1) Lead K7 is not energized. In other words, the Sascla 
address bus is not in the range 1C00O to 1FFF; ose3se 
2) The SYNC signal is high, which means the processor meses ss 
is fetching an instruction. (See page 44 of the gna Ee 
Hardware Manual). Sa wees 
Put these together, and what do they mean? Just this: Ress we 
that if the SST switch is on, and we fetch an instruction ox 33 
that is not in the Monitor, the NMI interrupt will be Ss Bod 2 
signalled. The instruction in progress will be completed. onxs* 52s 
Then, if we have set up our vector correctly, the micro Fm ff z 
will return to the executive, neatly dumping the registers gRe 23533 
as it does so. (Pressing GO for the next instruction Bzrgass 
reloads the dumped values so that the next step continues pie epee at Ey 
with exactly the conditions left by the previous one). niseed Sy 
This is a really neat mating of hardware with software. ak Bess ge 
The hardware allows the Monitor to run freely; but any S9Ssr bak 
other instructions are immediately interrupted, and the eo 8 3 =2 
Monitor takes over again. The software, on the other hand, Ele 
stacks away the register contents, and restores them when ° re Sa 
the GO button is pressed again. Elegant, huh? 2 Sss 
Last word on interrupts: if you plan to expand the won a 
KIM-1 system, all of these features are available for gee 2m 
you to modify. Chapter 6 of the KIM User Manual = B38 
(Expanding Your System) gives quite a bit of material Ay 
on this. 8 
a i  D & 
Digital Tape Drives for KIM-1 Robert E. Haas 


2288 Blackburn St. 
Eugene, OR 97405 


As I stated in a previous newsletter, I am developing an assem- 
bler for KIM, and I planned to use the KIM tape I/0 system for source 
input and object output. However, I have encountered several prob- 
lems including low reliability, slow speed, and general frustration 
with the limitations of audio cassette recording. I have instead 
decided to interface a commercial-quality digital storage device 
to my system. I have chosen the Mini-Raycorder Model 6409 by 
Raymond Engineering, Middletown, Ct. This drive uses a miniature 
version of the standard Phillips cassette, a digital-certified vers- 
jon of the one being used in some newer dictating equipment. The 
drives cost $350 in singles, declining to less than $200 in large 
quantities. I would be willing to organize a group purchase of the 
drives to take advantage of quantity pricing. I will distribute 
my interface hardware and software design, as well as my assembler 
to anyone participating in the group purchase, for the cost of dis- 
tribution. 

The hardware portion of the interface consists of 4 bits of 
latched output and 5 bits of input (already available on the basic 
KIM-1). The dirves give the computer full control over tape motion 
(forward/rewind), and read/write status, and let the computer sense 
cassette-in-place, tape position (beginning or end), cassette write- 
protect, and cassette side. The technical specs of the drives are: 

Recording modes bit serial, bi-phase, 800 bits/inch. 

Tape speedt 3 in/sec forward, 20 in/sec rewind. 

Transfer rate: 2400 bits/sec (300 bytes/sec). 

Tape length: 50 feet. Capacity: 60,000 bytes/side (2 sides) 


Anyone interested in the group purchase should send me a stamped 
business-sized self-addressed envelope, and indicate how many drives 
you wish to purchase. 


eb 


Ronalé tue 


BUT FIRST 30M% CRITICISM. «+ 3108 addison Court 
Corowelle Heights, Pa. 13020 
1. The relutive branch table hes became one of ay most useful tools / 


once i figured out how it works. Perheps « word of explanation was in 
order. 


2. The driver circuit for the Kluge Harp originally presented in October 
1975, BITE, coneietes of a 7437 (not wentioned in the useere notes) 
as a set-reset flip flop and buffer. The seme circuit in the users'e notes 
does nothing wore then buffer and could just ee well be replaced with the 
original driver cirouit presented on Page 57 of the Kim User Henua! 1 
otion 
regiatere; ae oppoeed to keeping PaDD & PADD aa outputs and iocrementing 
the data registere. 














3. There seeue to be sous confusion regarding the interval tim 
how to use thom. Hr. Lutz lieted the addreseee of the “other ti 
the same cenner ae the Kia Program lietinge does on Page 3 of the User 
Manuel. Thia was confueing to me, and I hope to clarify the timere’ 
applications. 





4, I ehould hope that the"User iiotes® does not become a software catalogs 
where the average entry gcoee something like - *I just developed a progres 
for Chineee checkers, which I'll eell to the menbere for juet $10.00 plus 
ding an iseus of “User No! feel a tremendous 
obligation to write something; whether it be # program or juet a letter of 
appreciation for the wealth of 1oformation that the notes eontein. I 
should nope that tbe other meabere feel the same and are willing to share 
their software in tbe knowledge that the hours they spend developing a 
program will be rapeid weny fold by the cuguletive contributi of many 
authore of our group. It's the only way that the “Usere Notes® can rewein 
viable. 























INTERVAL TIMERS 


USING THe JNTEAWAL TIMeR AS _aN IRQ INTERRUPT 
Firet r ph l. 


Pi ‘Applications for Interrupte* in the 

re Henual. After reading the above paragraph it becomes 
easier to imagine the interval timer es s separa tity juet like a 
keyboard, control pi diepley. The Timer ie u to 
independently time « certain interval duriog which « program ie 
operating. Ths “during shich* ie important becauee it ellowe the 
progrem to do other thinge bee waiting in a deley loop for the 
interval to time out. Thies independent operation (non-relience on 
delay loops within the prograa® particulerly valuable. 
Once tbe timing inte ery for the timer to 
signel the microprocessor. 















Thie is done with the IRy interrupt which enters the proc 
through PB7. If P37 19 set up 





jeor 

#0 input (0 in PBDD), « low oo 

that pio causee the program to jump to whatever te in the IRy Vector 
located at 177K, 17FF- In otber worde, say you want to do « progres 
in 0000 to 0100 for « short time then ewiteh to 0300 and do « different 


Progrez. By losding 0300 in the IRy Vector and eetting the timer thie 
can be accomplished. 











TIMER Av ORES SING 


ae can be nin the addrees teble, 4} controle whether or not FB7 
ie enedled es an interrupt line. 





If you are not using the interrupt capability of the timer, read or 
write into 1704 to 1707. As an exempl during « loop in « progres you 
way continuelly check to see if the tiser ie done using the LDA (1704 to 
1707) and the Bit instruction. 








If you ere using the interrupt capability, use addresees 170C to 
170F. The important thing here to remember is that when reading the 
time efter an interrupt go beck to 1704 to 1707 #0 es not to enable 
PB7 agein until required. 


p.& 


( ADDRESS TABLE 











TIME 
ADDRESS LEAST SIG. ADD. BITS DIVISION USE 
- AD Al 

1704 1746 ‘ 1 q +1t Use these addreases to read 
1705 17465 6 1 6 +8T or write to the timer when 
1706 1,46 g 1 1 + 64T = not using interrupt mode on 
1707 1747 O11 +.1024T . PB7 or when reading after 
1708 1768 re rr ee eee =) interrupt__A3 = 0 
1709 1749 1 6 q - / These addresses are not 
170A 176A 1 ¢ 1 - cC used with interval timer 
1708 170B : Az = 9 
170¢ T74c I @ + IT “S These addresses are used 
70D 174D 1 ot g + 8t (when the IRQ interrupt 
170E 174E 0 + 64T <” capability at PB? is 
170F 174F Pook Ae #10247) needed Ade 1 








Cass R. Lewart 
12 Georjean Dr. 
Program to check KIM-1 keyboard condition Holmdel 
eas New Jersey 07733 
The following program will check individual keys for excessive 
bouncing. If an oxide layer builds on the contact surface 
depressing a key will cause several “bounces” or on and off 
conditions which may cause multiple or erroneous entries. 
The program checks the key every n microseconds and writes 
either FF for contact open or a different code into page 2 of 
memory. Thus we get 255 samples of the contact closure which 
we can easily review by calling the previously described 
Display routine (set MULT in that routine to 1 for faster 
scan). Set the word #10 in the keyboard program to 00 to 
check keys 0 - 6, to 02 to check keys 7 - D or to 04 to check 
the remaining keys £ through PC. You can not check keys ST 
and RS. The time constant betweer, successive samples is set 
by the value in word #23. The multiplier value is 4 micro- 
seconds times word #23. 


00 AQ FF LDA #FF Set initial delay 
02 86D O7 17 STA 1707 
' 05 2c 0717 @ 3s1T 1707 Check timer 
08 10 FB BPL@ 
OA AQ LE LDA #1E Set PB1-PB4 to output 
oc 8D 43 17 STA 1743 
OF AD xx ‘ LDA xx : xx = 00, 02 or 04 (see text) 
ll 8D 42 17 STA 1742 
14 ag 80 LDA #80 Set PAO - PA6 to input 
16 «8D 41 17 STA 1741 
19 aD 4017. @ wa 1740 
1c C9 FF CMP #FF Check for key depression 
1E£ FO F9 BEQ@ 
20 A2 00 LDX #00 Key has been depressed 
22> «AO yy @ wx syy yy - multiplier 5 - 10 
24 «88 @ obey 
25 DO FD BNE @® 
27 AD 40 17 LDA 1740 Delay finished 
2a 9D 00 02 STA,X Write on page 2 
2D Es INX 
2E DO F2 BNE @) Continue with next sample or end 
30 00 BRK ¢% Stop 


Notet The reason for not using AK or GETKEY routines in this 
application is that they are too slow to detect the bouncing. 
To check e.g. key "A" set word 10 to 02, start running the 
Program at 00 by pressing GO. The display goes blank until 
you press A. Go then to location 200 and start reviewing 
contents of the 2-nd page. Each FF means a contact bounce. 


EDITORS NOTE: I changed the BREAK instruction to a JMP to 1C4F to get the program operational. 


This program cen detect the bounce of ANY ewitch by just hooking 1t up to 
the proper keyboard access pins @m the KIM edge connector. 


ae : 


Cass R. act 
Holmdel, nw” ‘97733 


Display Routine 


This routine will display any program showing each successive ’ 
location and the contents of that location. The routine is fully . 
relocatable. By storing in the 17FA and 17FB locations the 

starting address of this routine one can use the ST key to 

start the program. The display can be stopped by pressing RS 

and continued by pressing ST again. The program starts dis- 

playing consecutive locations starting with the location shown 

in the display by pressing ST. The second program location Mult 

controls the display time. With value 04 it is.4 sec per location. 


00 =A2 04 LDX Mult 
02 «BA TXA 

03 «48 PHA 

04 a9 62 LDA #62 (.1sec /eycle ) 

06 8D 07 17 STA 1707 Load timer 

09 2019 1F @ JSR SCANDS Display 

oc 2c 07 17 BIT 1707 Check timer 

OF 10 FB BPL 

11 68 PLA 5 

12, AA TAX 

13° 0CA DEX 

14 DO EC BNE @ 

16 £6 FA . INC FA 

18 DO E6 BNE @) 

1A E6 FB INC 

1c DO E2 BNE 

iy te ster Lisptay sig a€ BIO + A0,0,2, 1,9, ST got Restrnt 


Th Me O1s0umy atonts at Foo: &0,1,7,6, 4,0, 0,0, ,0,3, AB, 

bocetten, SK 
Mr, Lewart also enclosed additional details about accessing the keyboard and display which 
will be included in an upcoming issue the editor 


MORE FROM CASS LEWART 
1, KIM LED INTERFACE: The inexpensive ($0.45 from Altaj Electronice) IC #75492 LED privm ! 
Provides an interface for 6 LED's or lamps (editors note- the 75492 can SINK up to 250 aa. 
#0 anything it drives should be tied high . This chip can drive relays, lamps or whatever) 











+ s +. we 
Leo 
i NTH 
: 1 tol 100 ~ $00.0 
FROM 
«kim Yo loads,“ 4 Small rela 
small Svars <250ma 
lame 








2. KIM AC INTERFACE: This circuit can be used to control lights, appliances,etc, up to 
watts. Though Sigma light-couplers are available from Allied Electronic: + it ie easy 
to make one by wrapping a lamp and a CdS photocell with dark masking tape. 


to light or 
appliance 





lamp ~ ag 
low-current lamp-6v. 25 ma, ie 
(RADIO SHACK 276-1140) ih 
CdS photocell (RADIO SHACK 276-116) 
Triac- 200v./6 Amp (RS 276-1080, GE SC142 or equiv.) tollov. 
OUTLET 


et 


HERE'S  wAY TO TURN KIM INTO A FREQUENCY COUNTER: 
FREQ. 


COUNT 


FROM: Joe Laughter 
Univ. of Tennesse 
Medical Units 
951 Court Ave. 
Ra. B23D 
Memphis, Tenn., 38163 


Counts freq. using input PBg,max rate 20 Khz; counts DATA for 1 sec. to 
count for 10 sec. load #29 into adr 60. 


PB7 to INT. REG.) 
0000 AS O01 
0002 85 65 
0004 F8 
0005 Ag 36 
0007 8D FE 
000A AS 00 
oo0c 8D FF 
ooor 58 
0010 00 
0011 EA 
0012 AD 02 
0015 29 01 
0017 DO F9 
0019 AD 02 
oolc 29 O1 
oole FO F9 
0020 18 

* 0021 Ag O01 
0023 65 Fo 
0025 85 F9 
0027 AS 00 
0029 65 FA 
002B 85 FA 
002D Ag 00 
002F 65 FB 
0031 85 FB 
0033 ac 12 
0036 48 
0037 AS 90 
0039 8D 04 
003c 2c 07 

‘ 003F 10 FB 
0041 aS F4 
0043 8D OF 


17 


17 


17 


17 


00 


17 
17 


17 


CK LOW 


CK HIGH 


LDA 
STA 
SED 
LDA 
STA 
LDA 
STA 
cLI 


BRK 


Uses PB7 for int. req. (connect 


#01 
TMECNT 


# INT LOW 
FE 


SET INT. VECTOR 


# INT HIGH 


17FF 


NO OP 


LDA 


BNE 
LDA 
AND 
BEQ 


STA 


LDA 


STA 


PHA 
LDA 
STA 
BIT 
BPL 
LDA 
STA 


PB 

#01 

CK LOW 
PB 

#01 

CK BIGH 


#01 
Fo 
Fo 
#00 
FA 
FA 
00 


FB 
FB 


CK LOW 


#90 
1704 
1704 
DELAY 
F4 
170F 


CHECK FOR INPUT LOW 


CHECK FOR INPUT HIGH 


ADD COUNT TO TOTAL 


CHECK TIME 





0046 
0048 
004A 
0048 
004c 
004E 
0050 
0053 
0055 
0057 
0059 
00sB 
00s5D 
OOSF 
0061 
0063 
0064 
0065 


0066 


cé6 


68 
40 
Ag 
85 
20 


cé6 


ag 
85 
85 
85 
Ag 
65 
68 
40 
05 


FP 


bear bric: 


65 
02 


FF 
66 
1lF 
66 


Fg 


Fo 
FA 
FB 
05 
65 


lr 


DISP. 


DNC 
BEQ 
PLA 


LDA 
STA 
JSR 
DEC 
BNE 
LDA 
STA 
STA 
STA 
LDA 
STA 
PLA 
RTI 


TME CNT CRECK nt AING TIME 


DISP IF ZERO DISPLAY COUNTS 
FP SET DISPLAY LOOP CNT 
SCANCT 

SCANDS OUTPUT DATA 

SCANCT ¢% DEC. LOOP CNT 


out REPT. DISPLAY TILL LOOP 
oo COUNT IS ZERO 

F9 SET TOTAL COUNTS TO ZERO 
FA 

PB 

05 RESET 1 SEC. TIMER 
TMECNT 


“DATA (TMECNT) 


“DATA (SCANCT) 


Ooh Box t 
1250 White Oak or. 
Cookeville, Tn. 38501 


As a fellow KIM-1 fan may I wish you well on the USER NOTES 
undertaking; 
contribution (if anyone is interested) I am enclosing a photo of how I 
mounted my KIM-1 in a cabinet and provided expansion room for future 
projects. 


they are most useful and interesting. As a small 


One of my interest was driving outside devices and I came up 
with the following scheme to give up to 16 1/0 ports (8-bits ea). 
The system uses six pins of port B and three pins of port A plus 


some external hardware. 


The amount of external hardware required 


depends upon the number of devices connected but runs about three TTL 
chips per device plus the nardware driver. 


briver software is in RAM, I used locations 1780 thru 17DB. An 
input or output to a device reguires about 300 microsec if the device 
is ready to accept or receive data. 


Figure 1 snows the hardware driver, figure 2 a typical device 
interface and figure 3 the software listing. I use an old Model 15 
(S-level) teletype and a UART, this interface is shown in figure 4. 


I can supply more details if anybody wants if they will send a 


S.A.S.E. 


du ft p10 


the good work-- 


—_ 


Fraure { 
HarowaAre Drvee 1G xeqo ) 


aes) 
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vo 
f vewce (WHIBI Lines 


} 
Device [Steoed Lwes 


Lecania) ; 
Iwitialize: 1idl to Hex ‘of 
1193 to Hex ‘3F’ 








7 bse 32td 
8-B;rs To Devee 


“wv Wig IF DEVKE puny 
ia 1400 


Tere Qureur_wreeens ¢ 


SB wut cHANNELS 


vevce [Fag] :Feom (NPUT 
: Devices (8) 
ices] 
(DoT| ouTPuT fo Aw 
ouTnIT PEV KES 
st] 
Pevice Setecr 
Lies (10) 










110A 





UNS 
44-1400 


Soliware Ufo deer 


es 

[186-26 CA IT 

1193 56 FB 

1795 Ab $8 

1787 = O# IT 

118A 4A 

79860 tl O66 IT 

1186 36 6D 

1796 €£ $217 

193 «CE OZ IT 

1% «(88 

at og Fl 

wa BE G2 17 

ime od 

11970 OY 66 

1797F 30 EF 

H 

ITAA 26 CA IT 

17A0 59 FO 

ITAF = AG G8 

‘761 «48 

162 26 O417 

76568 

"1% 80 66 IT 

11789 «EE bz iT 

1706 CE #217 

er HA 

icp 88 

(11 Dp F3 

1103 86 $247 

ceo 

ITA 8 $217 

'1cp 26 O86 17 

1106 ob 

'ip4 oA 

1105 99 26 

1701 80 2 IT 
6 


obct 


Hig 1& CEveg Busy 


TYPICAL 


sWPUT SuBKOUTING 
Gereyre: JSR CKFLAG 
BVC GerByTe 
Loy #4199 
JSR IWHIBIT 
L£5R A 

BIT PAD 
BMI AONE 
INC PED 
bec PED 
OEY 

BNE kopIT 
$Tx FED 


RTS 
ork #498 
BMI NExr 


RoOBIrT: 


MExT: 


Aone: 


jOumur SuBeouTWwE 
PUTBYTE: JSR CKFLAG 
8BvC fureyre 
Loy #39? 
PHA 
JSR INHIBIT 


PLA 

STA PAD 
Wwe PEO 
DEC PED 
L5R A 
ver 

BNE BuRP 
STX FED 
RTS 


MISC SUBROUTINES 

CKFLAG: =STX PED 
BIT PAD 
RTS 


TXA 

ORA #€$26 
STA FED 
RTS 


BukP: 


INHIBIT: 





qf Ait 


© Birs from Deve 
‘ 





(max. of 8) 


INPUT ‘Device INTERFACE 


jSee 1F Deva Avan, 
pe wat 
Ser Sir Counter 
jZusueur oevice 
j Move ovee 
jOWece air 
"FoR Aa 
. j Mope -- - SMIET 
j va sTeoag Live 
} Couwr 
j Qo Moca 
j EUABLe Device) 
jAwo LeETURW 
j Mae Br] A we 
2 awn ST LOBE 


ites JF Busy 
j YES, WAIT 
5 ar Coumerk 
5 Save Byte 
jf WHET DEVICE 
j Resroee By 
j SET our arg 
j ITROBE FoR 
3 SMIFT . 
jMove OveR 
; CouwT 
j Do Mere 
jlore, EWABLE 
* Awd " ZeTURAL 


jSececr Devee 
j Ftag Bir e 
3 eTurw V- Bir 


jder Dev. Aove. 
Ser MIT BIT” 
james DEVE 
j Revues 





ca a 





( Fiquee I 
UARCT ‘INTERFACE 
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uUAeT 
[pss 1- Rego 
Cioese 55S Timee 
As Astree 
@ l6X baud vate - Evo 





HAVE YOU BEEN HAVING PROBLEMS OPFRATING YOUR KIM=-1 CASSETTE 
SYSTEM RELIABLY ON AC POWER?THE MAIN PROBLEM MAY BF DUF TO AN 
UNREGULATED POWER SUPPLY. 

SINCE ACQUIRING “Y KIM-1 SYSTEM | HAVE HAD A PROBLEM OPERATING 
MY TWO AUDIO CASSETTE UNITS WITH AC POWER. THE PROBLEM SYIIPTOM 
WAS NOT BEING ABLE TO ACQUIRE SYNCHRONIZATION .HOWEVER THEY 
OPERATED FINE ON RATTERIES.FXAMINING THE CASSETTE OUTPUTS j 1 
FOUND A HIGH AC RIPPLE AND POOR VOLTAGE RFGULATION CAUSFD BY 
UNREGULATED POWER SUPPLIES. 

MY SOLUTION WAS TO DESIGN ANG BUILD SEPARATE REGULATED POWER 
SUPPLIES FOR EACH UNIT[6.6V AND 7.5V).THIS HAS YIELOFD VERY SATIS+ 
FACTGRY RFSULTS.SEVERAL TIMES THF UNITS HAVE RFAD 126-256 BYTE 
DATA PAGES WITHOUT ERROR, 

RECENTLY, 1SUCCESSFULLY READ A COUPLF OF 256 BYTE PAGES USING 
JIM BUTTERFIELOS SUPERTAPE.1 AM LOOKING FOWARD TO 'TS TIMF AND 
TAPE SAVINGS. 

CHUCK BALSER 
|3 1h OVERBROOK CIRCLE 
5 NEW RARTFORD,N.Y. 135813 


HERE'S AN IDEA FOR PACKAGING KIM: FROM: NIGEL NATHAN 
12 STONEHOLM ST.,f 3 
BOSTON, MASS. 2h 


I used a standard Bud chassis, turned upside down, with a clear plastic top. The latter 
I painted black on the underside, except for the display area and the keyboard cutout. I had 
originally planned to project the keyboard through the opening, but had too hard a time trying 
to desolder it from the circuit board. The present arrangement is quite satisfactory and the 
circuit board has complete protection. The power supply is at one end, so there is plenty of 
room for expansion circuitry inside. I use wirewrap backplane sockets to bring out the applic- 
ations connections as DIP plugs are male (live pins) and fragile. I use wirevrap extensively. 








Section 


1) KIM-1 8) Phono jacks for tape recorder (3) 
2) 10"x12"x3" Alum. chassis 9) Wirewrap backplane connectors (2) 
3) 10"x12"%1/8" plexiglass for applications 

4) 7/16" long standoffe (5) 10) Applications connector 

5) Power supply 11) Sheet matal screws (10) 

6) Power ewitch 12) Rubber bumpers (4) 

7) Line corD 13) System ground point 


14) Rubber edge moulding 


eh 


‘ = ‘ 
ACOUPLE & "RANT MATH SUBROUTINES FROM: H.T. Gordon, College of Agriculture, Univ of cai 
\ Berkely, California 94720 
Program :.uLTIA (second, revised version). Does dinary multiplica- 
tion of two 68-bit numbers that have been stored (before the JSR 


=z 
to MULTIA) in 00E3 and OOE and are destroyed by the operation of YOGaS 
the subroutine. The hi 6 bits of the product are stored in O0EO ooo 
and the low 6 bits in OOEl; the subroutine initially zeroes these red 
locations, and also OOE2., Operations used LSRs on the multiplier we w 
in OOE} to move up to 8 bits in sequence into the carry flag. If bag yd 
the carry 1s set, the multiplicand (in 00B2 and 00E3) is double~ elo & A 
precision added to the product locations. If bits remain in the ary 
multiplier (OOEk not zero), the multiplicand is shifted left in the ais & 
16 bits of OOE2-00E3; otherwise the subroutine exits. Program ales # 
length 36 bytes, Maximum product (FF X FF) is FEO] or decimal a’ , 
65025, with execution time about 380 microseconds, Time declines to olog q 
$5 microseconds for 80 X 80, 160 microseconds for 10 X 10, 70 3 eB 
microseconds for 01 X Ol, 40 microseconds for 00 X 00. ae 
He 
000A a9 00 {zeroes locations O0EO to OO0E2) oau 
85 E2 gE 
85 El 200 
85 EO 3=¢ 
0012 46 Ey (LSR OOF}, lowest bit into carry) 2g 
0014 90 OD (if carry clear, skip the addition) (go to 0023) Baa 
eouc 
0016 18 (CLC starts double-precision add) bat ft -3 
aS El Sho 
65 £3 (running totaks sored in 00E0-00E1) ean 
85 El pipe 
001D AS EO le 8 
65 E2 Bo3 
85 EO Les 
0023 aS id (LDA of OOE}, zero flag set if zero) Pray 
FO (exit to 002D if zero) gs 
: u 
0027 06 53 (ASL shifts highest bit of 00E} into carry, She 
26 £2 ROL snifts carry into lowest bit of Ore) eae 
002B 90 ES (carry is always clear, so back to 0012) 
0o2D 60 (RTS exit) 


SUBROUTINE DIVIDA. This software gives the quotient, to 
16-bit or better precision, from division of any hex nuaber 
from 0001 te FFFFP by any hex number from 01 to FFP. It uses 
the 10 lowest locations in sero-page. The quotient appears 
in the lowest 5, with a fixed decimal implied betweem 01 
and 02, The range of quotients is froa§ 0600 .010101 (from 
division of 0001/FF) to $ PFFF.000000 (from division of 
PFPP/Ol). Quotient locations are initdally zeroed by a 
JSR to SUBROUTINE ZEROER,‘which must also be in memory and 
ie ceded separately for use in other programs Before the 
JSR DIVIDA, 4 locations must be filled by t calling 
The dividend nigh byte is t in 06, the low byte 

d the divisor in 08, The "precision byte”, with a 

from Ol to 05, is set in location 09; it is not 

altered by the prosraa, but the other 3 bytes usually are. 

The purpose of the precision byte is to allow the user to 
control the number of quotient locations to be calculated 
by DIVIDA. A value of Ol causes exit after the proper 
quotient value in location 00 (wnich may be 00) has been 
calculated. A value of O02 limits the calculation to que- 
tient locations 00 md Ol, and gives “integer arithmstioc", 

A value of 03 allows only one location to the right of ths 
implied decimal, etc.. The chief use is to shorten the 
exeoution time, which can approach 2000 microseconds at 
a precision of 05, However, DIVIDA always exits when the 
calculated remainder is zero, since calculation of higher- 
precision locations is then unnecessary. No “rounding-off" 
operations are included. &.g., the quotient of FEFE/FF 
ie OOPP.PDOOOO at a precision of 03, although it should 
cr one since the quotient is OOFF.PDFDFD at a precision 
° . 


p15 


















DIVIDA exits in less than 150 microseconds if the ( 
dividend is 0000, It provides no protection against « 
divisor of 00, so the calling program should guard against 
this! am A guard could be inserted in DIVIDA, but I feel 
it is better for the calling prograa [what should be done {te deeide) 
if such en error occurs. 

Operation of DIVIDA involves addition of a shifting 
single-bit “Bit-Byte” in location 05, to the quotient location 
controlled by the X-register, whenever a positive remainder 
is obtained. The X-register is not protected by DIVIDA, so 
it is better to use Y-indexed loops in the calling program 
(that otherwise will have to store and restore the X value). 
The final remainder is in location 06 when DIVIDA exit 
The divisor value is not altered if it is $ 80 or more; 
otherwise it is left-shifted by DIVIDA. 

DIVIDA {£® very long (70 bytes, or 78 if one includes 
ZEROER; if the zeroing operation eo made an integral 
part of DIVIDA the length would be 7h byt and execution 
a shade faster), It is also slow compared to hardware 
arithmetic, but relatively inexpensive, It is meant to 
handls data, that are never very precise, and not the kind 
of complex math for which calculators are designed. Since 
the ROR instruction is not used, it will rum in any 6502 
system, 

Much of the length of DIVIDAis caused by special logie 

designed to reduce the execution tine---a deliberate trade- 
off of more program bytes for a lower 


the effect of prolonging the time of d 
early exit is poss e. 


Coding for SUBROUTINE ZEROER. 

















ons whsre no 


+0200 a9 00 (LDA # 00) 

95 FF (STA saro-page, X) 
020% CA (DEX) 

DO FB (BNE, if # 0 back to 0202) 
0207 60 (rts} 


Coding for SUBROUTINE DIVIDA. (Note that 3 locations are 
unused between the end cf ZEROER and the start of DIVIDA, 
This is to allow users (if the subroutines are in RAM) to 
insert 3 instructi following the LDA divisor instruction 
at 0213. If the divisor is 00, DIVIDA Is Seappadxtuxam wreng. 
andiasaxinap. The instructions DO 01 00 substitute for 
this a BREAK to 1C00. If something more complex is needed, 
the 3 instructions can be a JMP or JSR te a longer sequence 
of instructions.) 











020B A2 06 LDL # 06) 

20 00 02 JSR ZEROER, to sero 0000 to 0005) 
0210 «38 (SEC) 

26 0! (ROL sets Bit-Byte to Ol and clears carry) 
0213 aS OO (LDA divisor byte) 

30 05 (BMI, if Bit 7 = 1, skip to 021¢) 
0217 26 05 (ROL Bit-Byte) 

OA (ASL, left-shift divisor in accumulator) 
O21a DO 2 (BNE, if # 0, back to BMI at 0215) 

85 Oo (STA bit-pattern 1XXX XXXX into divisor lee.) 
021B aS 06 (LDA dividend-hi) 

BO OF (BCS, if carry set go to subtraction at 0231) 
o22@ Do 09 (BNE, if # 0, go to CMP at 022D) 

as 3 LDA dividend-1o) 
0226 FO BEQ, dividend = 0 so exit to 0250) 

85 06 STA dividend-lo into dividend-hi location) 
0224 86 07 _ (STK zeroes dividend-lo) 

56 (INX to shift to next higher quotient loc.) 
o22D cS 08 (CMP dividend-nhi with divisor) 

90 OB (BCC, divisor too large, bypass to 023C 
0231 BS 08 (SBC, subtract divisor from dividend-hi 

65 06 STA remainder into dividend-hi) 
0235 «sil CLC for addition) 

BS 00 {LDA sero-page,X the proper quotient byte) 
0238 65 05 (ADC the Bit-Byte) 

95 00 \ (STA sero-page,X back into quotient loc.) 


ale 


A 





(completi ¢ coding for DIVIDA) 

023¢ «46 05 (LSR the Bit-Byte) 
DO 09 (BNE, if # 0, bypass resetting} 

o2ko EB {INX to shift to next higher qtotient loc.) 
EE 09 (CPX to precision-byte) 

0243 FO OB (BEQ, if equal exit to 0250) 
ag 80 LDA # 80 to reset) 

0247 85 0S STA into 05 resets Bit-Byte) 

0249 06 O07 (ASL dividend-lo starts dividend left-shift) 
26 06 (ROL dividend-hi completes the shift) 

O2D kc 1B 02 (JMP to O21E for next test sequence) 

0250 60 (RTS) 


Execution time depends both on the number of quotient 
locations to be filled and on the number of l-bits to be 
inserted, Thus, PFFF/Ol runs slowly because it requir 
insertion of 16 l-bita into 2 locations. The "hi/lo 
exchange" operation at 0228 speeds up many operations with 
a dividend of OOXX. In general, higher speed will require 
sacrificing precision, and a pracision-byte of 04 will be 
adequate. My reason for limiting the dividend to 16 bits 
and divisor to 8 bits was that data more precise than 1 part 
in 256 will be rare, so that most data will be single-by 
and data sets with more than 256 items will be uncommo! 
Calculation of the average of 255 one-byte data items is 
within the capacity of DIVIDA. When there are more, they 
can be divided into subsets of 255 or fewer, the averages 
for all sub. 8 added id the average of the set of 
subsets calculated, re now in the time ge of 
seconds! With more bits, it would be minutes. People who 
need arithmetic speed had better get a I6-bIE micropro- 
ares better still, shell out for hardware multiply- 
divide). 














Those who want integer arithmetic operations will do 
better using a dividend of type XX00 and precision-byte 
of Ol. However, similar eftects can usually be obtained 
more quickly and easily by other logic, not division, 
The number of poesible ways of doing division is incredibly 
large, but I wit be surprised if an operation like that 
of DIVIDA can be done with many fewer bytes or much higher . 
speed, although using the ROR instruction might help. 





EE 
HERE'S A RELATIVE BRANCH CALCULATOR ETC, FROM: 
Arlington, Va, 22207 


Tam enclosing for your perusal two programs I find to be very helpful in writing asses! 
lanquage programs on KIM, wr oe id 





‘ed Beach K4MKX, 5112 Williassburg Blvd., 


Also, way I say that the Users ‘Notes has already proven worth the money - even after only 
two issues. Mr. Butterfield is fantastic, and I really dig hia SUPERTAPE - worth the money all 
by itself! You can add the Norelco 150 Carrycorder to the list of "always works" machines. 


Mine is about 15 years old and I don't think they are imported any longer, but it is a real 
good machine, 


In addition to the two programs, I have a simple hardware modification which allows the 
KIM to be etarted in the monitor mode - a power on reset function which is very easy to add. I 
built the whole thing on a small piece of perf-board which dangles from the expansion connector. 


One other hint I have found helpful when loading multiple section programe (like WUMPUS) ie 


ee the same ID number, and before loading the first section into KIM, make the following 
entries: 


OOEF 73 
ooFo 18 


This ia the program counter location, and after getting the firet section of the program 
into KIM, leave the recorder running and punch PC, GO real fast and you're ready for the next 
section. Also, if you should happen to drop a bit and get an error exit (FFFF 1C), pressing 
PC gets you back to the tape-read program in a hurry without having to key in 1873, 





An there you have it, Eric. Do keep up the good work and let me know if there ie anything 
I can do to help you with the User Not I am at preeent teaching KIM to talk BAUDOT so I can 
use # cheap 5-level printer soon. Will keep you informed. It looks like a one-page program 
right now. Next comes Morse, etc., followed by a home-brew ASCII keyboard and more memory. 








| 





Branch Calculator = Ted Beach — KLixX ( 


0200 D8 ENTER CLD 22 20 &@1F JSR GETKET 
0201 38 CQ.PUT SEC O2hS c9 15 Gp #815 
0202 AS FA LDA POINTL 02h7 10 £3 BPL BEGIN 
020 ES 00 SBC SAV 02h9 c9 12 cp #812 
0206 85 F9 STA INH O2hB FO 18 BEQ SAVE 
0208 AS FB LDA POINTH O2kD cy lb cup #$1L 
020A ES OL SBC SAV#1 O2F FO BO BEQ COUPUT 
020c 30 OE BI NEG 0251 c9 10 CKP #810 
O20E C9 00 CUP #0 0253 10 D7 BPL BEGIN 
0210 po 1k BNE ERROR 0255 OA DATA «ASL A 
0212 AS F9 HIOK LDA INH 0256 GA ASL A 
0214 C9 80 ap #%80 0257 OA ASL A 
0216 10 08 BPL ERROR 0258 A ASL A 
0218 A9 00 our LDA #0 0259 Az Ob LK = #$0u 
021A FO 0c BEQ DISP 0258 OA DATAL ASL A 
o21c C9 FF NED CMP #$FF 025¢ 26 FA ROL POINTL 
C21E DO 06 BNE ERROR @25E 26 FB ROL POINTH 
0220 AS FY LDA INH 0260 CA DEX 
0222 9 80 ap 7860 0261 DO F8 BNE DATAL 
022h 10 F2 BPL OUT 0263 FO C7 BEQ BEGIN 
0226 AQ FF = ERROR LDA #SFF 
0228 85 FA =s-dDISP_—s STA POINTL, one a a : oe ux La 
if 
O022a 85 FB STA POINTH 0269 98 00 STA SAV,X 
+ ©22C 201F 1F BEGIN JSR SCANDS cA DEX 
022F DO FB BNE BEGIN 026c 10 FY BPL SAVFL 
0231 A9 OL —s-BEGINA LDA #401 0268 A2 aL Lox #401 
0233 20 LO 17 BIT SAD 0270 800 = aDD2sING SAV 
0236 FO FL BEQ BEGIN 0272 DO @ BNE NEXT 
0238 20 1F 1F JSR SCANDS 027k «6 OL INC SAVel 
0238 FO Fy BeQ BEGINL 0276 CA MeXT | DEK 
23D 2 1F IF JSR SCANDS 0277 10 FT BPL AD02 
O2hO FO EF BEQ BEOINL 0279 30 BL EMI BEGIN 
0278 (LAST+1) 


Two page zero locations used: SAV = 0000 
SaV+l = OOOL 


You can enter the program at any point, however 022C is the best place, 


To use the program, enter the address of the branch instruction via 
the keyboard and press + for enter data, Next enter the destination 
address of the branch via the keyboard and press PC for perform 
calculation. The display will show 0000 XX, where IX is the offset 
value to enter in your program. If you see FFFF XX, the branch is out 
of range. 


The addresses to use in the calculation are the actual line addresses 
of the instructions, not the actual location of the start of the br,nch. 


For example, to compute the offset for the branch instruction at 

address oz2h in the program, enter 0 2 2 +. The address of the 
destination (OUT) is entered next : 0 21 8 PC and you will see displayed: 
0000 F2. 


If you make a mistake entering an address, just re-enter it, like you 
do when using the KIM-I monitor program. 


The program is completely re-locatable as there are no jumps other than 
to KIM subroutines, 


(The rather inefficient coding at SAVE happened when I was fooling around 
with indexed addressing c.uld be simplified to: LDA POINTL, STA SAV, 
LDA POINTH, STA SAV+] = bytes instead of Miki Also, the technique 
used at OUT - 0218 = is handy for a two-byte jump or a branch-always 
instruction like the 6800 type. Do something to the accumlator, knowing 
which flags will be affected, and then follow with a branch ~ real haniy 


se e- (6 


Program P) ‘er Ted Beach ~ KiMKX 


E 


1780 

1781 = SAL 

1782 = EAL 

1783 = NU 

1784 D8 cl 
1785 38 SEC 
1786 AD 8217 uA 
1789 ED &1 17 SBC 
178C AA TAX 
178D AD 60 17 mA 
1790 85 FB STA 
1792 8D AE 17 STA 
1795 8D Bl 17 STA 
1798 AD 81 17 LDA 
1798 85 FA STA 
179D 8D AD 17 STA 
17A0 16 cLe 
17A1 6D 8317 ADC 
17ak 8D BO 17 STA 
17a7_- 90 03 BCC 
17A9_ EE Bl 17 mc 
17A6 BD 00.00 DOIT LA 
17AF 9D 00 00 STA 
1722 CA DEX 
1723 EO FF crx 
1785 DO FS BNE 
17#7 kc LF 16 IMP 
17BA 


EAL+1 
SAL 


SAH 
POINTH 
1TAE 
1781 
SAL 
POINTL 
17AD 


wu 
1780 
DOIT 
1781 
SA,X 
SA*NUM,X 


WF 
DOIT 


START(return to KIM) 
(Last+l) 
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ao, i 
2 
fs) «% 
ts 

w 


wd 


wan lo BO 


This program alows one to move a group of data up in mamory so as to be 

able to insert extra bytes (1 to 255) in @ program. The address of the 

first byte to be moved is entered in 1780, 1781. The lower address ‘ 
of the last byte+l in the procram is put in 1782, The number of bytes 

you wish to insert in the program is put in 1783. Press + and GO and it's 

done, The program exits to KIM with the required starting address displayed 

60 you can write in your data immediately by pressing DA. 


As an exgple, I wanted to add two bytes to the Moon Lander progr. 





thé when in the FUEL mode, the display would show § sbo0 cerns PON Ki) 
required an ORA #$FO instruction just after SHOFL (0053). The address 

of the first byte to be mowed is 0065, which goes in 1780 and 1781. The 

last byte+l to be moved (lower address only) is C5 which is entered in ’ 
1782. I need to add two bytes, so 02 goes in 1783. Press + and GO and 

you'll see 0065 A6é displayed, Push DA, 09 + FO and ycu've done it, 


Now you'll have to change any branch 








which cross the patch by 02, and 


you'll have to add 02 to all addresses which follow the patch, as well 
as change the jump addresses... no real problem, and it sure beats re- 
entering all that date by hands 


I  D 


From the Editor - Mr. Beach's relative branch calculator is really slick! I's sure that all of 


us e 
by CLC BCC etc. 





@ to Save plenty of time. 


An absolute branch can also be achieved with 3 bytes 


The program patcher is a good starting point for a general purpose “move bytes" routine 
that could move bytes up or down in memory. It should work with programs of ANY length and 


way have to cross page boundaries. 
to lower addresses, it will ha 








Be aware, though, that if the move routine is moving bytes 
© Start pulling bytes down froa t! 





bottom end working up to 


the top end and vice versa for moving bytes upward in memory. Teds program patcher will not 
cross page boundaries and can only move bytes up in memory. 


And some more ideas for utility programs: A couple of articles in the Feb. issue of Kilo- 
baud really got the grey cells into a flurry of activity. The first article "Chasing Those 


Naughty Bits" (John Molnar) described an interesting “walkin; 
6800 that could very easily be rewritten for the 6502. John 


it" memory test program for a 
so introduced the readers to the 





idea of a "SYSTEM EXERCISER" program which would test ALL machine instructions capable of being 


executed by the CPU. 


fe!’ 


Another idea for the 6500 system. A SYSTEM EXERCISER and memory test pro- 


gram should be included with every system to instill confidence in the new eystes ower. 





Kilobaud #2 aleo had an article of intereet to those of us with termina i 


uJ The article "Cut programming time with this extraordinary Program" (Mark Borgenson P.104) 


described a hex loader routine to make loading programs go alot smoother. The Motorola "Mikbug” 
is similiar to the Kim Monitor in that as youload the memory, vie tersinal, sack memory loca” 


tion is printed out along with the contents of that location. To access the next location, ‘you 
punch the keyboard again and go through the whole procedure again and again. Borgenson’s al- 
ternative, (written for 6800 again) allows you to type in as many bytes as will fit on a line 
(whatever your terminal line length is). When going to a new line, the computer could indicate 
the next available addreas to be loaded. Provisions were included to allow backspacing the 
memory pointer to allow for error corrections. 











Converting programs from the 6800 to the 6502 ie relatively etraight forward once you 
are familiar with the program operation. 


Understanding the 6800 instruction set ie again straightforward once you know the 6502. 


Several new books came out recently which, although written about the 6800, could be use- 
ful to our purposes. I have not read either of thea Yet and would appreciate a review of these 
Publications by someone who has read thea, 


"Scelbi "6800" Software Gourmet Guide" (89,95) 
Scelbi Computer Conaulting Inc. 
1322 Rear Boston Post Road 
Milford, Ct. 06460 | Tel. 203-874-1573 


"6800 Programing For Logic Design” 49.50 
#500/ Adam Osborne 


Remember the Assembler ~ Text Editor that was mentioned on page 1 iseue #1? Well, after 
receiving several letters indicating that the assembler/text-editor had not yet been delivered, 
I decided to find out what the problem was. I talked with David Snow, president of Micro- 
Software Specialists. He stated that they were running into difficulties getting the asseabler 
together and had notified all who had ordered the package that they could have a refund if they 
80 desired. He also said that they hoped to have the package together shortly and further 
stated that the package would not be totally compatible with MOS Technology's croes assembler 
mesonics and operations (as had been indicated in a spec sheet that I had received). 


I would never have mentioned this had I known that it was not yet available, and recoe- 
mend that you hold off ordering anything from this Company until I can verify that tbeir soft- 
ware is, in fact, available for purchase. 


While I am on the subject, I have also received several letters indicating problems with 
interfacing KIM to OSI memory boards. One possible problem became apparent after a cursory 
Ainapection of the OSI application note on the subject. Addrees lines 10, 11, and 12 are driving 
& 74145 decoder on the KIM board. OSI recommends the use of 7417 buffers on all addrese lines. 
Since a 6502 can only drive 1 TTL load, problems can arise when address lines 10, 11, and 12 
attempt to drive 2 TIL loads, as would be the case vhen driving both the on board 74145 and the 
7417. Does anyone have more information about thie interface? 





One solution to the problem would be to sieply replace the on board 74145 decoder with a 
74LS145 low power Schottky device and use 8797 buffers inetead of the 7417's. The only probles 
ie trying to find a 7415145 (can anyone help out?). 


Some of you have no doubt received the "uP4" ( a newsletter ) from Johnson Computer, P.O. 
Box 523, Medina, Ohio 44256. (Tel. # 216-725-4550). Although primarily an advertising bro- 
chure, the "uP4" also contains data on MOS Techs latest chip offerings and other tidbits of 
information of interest to most 6502 users, If you haven't received it, and want a free copy, 
write to them. They stock ost MOS products (except for twe KIM 4 Motherboard and the 6522 
VIA ~ neither of which has been released as of yet). They also stock the MOS 7529-103 Scienti- 
fic Calculator Chip (available for $20.65, including postage, handling, and the 20 page documen- 
tation package) which will be interfaced to KIM in the next jue of the KIM-1 User Notes. I 
bought my chip from them so I know for sure that they stock them, They alse glock Kim-2,3. 


Coming Up In The User Notes 


The Ultimate Calculator Interface = uses the 7529-103 calc. chip, and interfacea directly 
to KIM's 1/0 ports with the addition of 9-750 ohm resistors. No special power requirements 
(just 5 volts and ground) and no other chipa are needed. A basic software driver will aleo be 
included. This interface was released as an application note from MOS but the I/O configura- 
tion and software had to be modified for KIM-] operation. 









KIM-1 Expansion - A series of erticles will be started pertaining to the expansion of KIM 
into a complete systea. 


AcHess cloce, REa-Tine Crocs. HaRowARE Toreneacer 20 
TE ELE geeks Ee ee tonite Ry re oe ee mea 


On PLEASE 


I eR va complete PLEASE software package (mentioned in issue #2) from MicroCosmos, 
210 Daniel Webster Hwy., So. Nashua, N.H. 03060. Even though I couldn't get the cassette tape 
to load correctly, I was quite impressed with the documentation that was provided. The source 
and object code listing is very well commented and the interpreter and monitor routines are ex- 
Plained in full detail. PLEASE includes a number of interesting games, puzzles and useful rou- 
tines (hex to decimal, decimal to hex, among others). Information is presented which ill en- 
able you to use the PLEASE monitor rout for you own programs. I have talked with several 
people who had no trouble reading the c tte so my case is probably the exception rather than 
the rule. Robert Tripp, author of PLEASE, has indicated plans for waking other software pack- 4 
ages uvailable in the future. 











On MICROCHESS 
and 

Peter Jennings says that his chess playing program is now available, runs on the basic KIM 

with no additional memory or 1/0. Peter goes on to say that for $10.00 he will provide a Play- 
ere Manual, a Programmers Manual, and a complete commented source listing of the program. He 
also states that the program is expandable, provided additional menory is added to KIM. For 
more information contact: MICROCHESS, 1612-43 Thorncliffe Pk. Drive, Toronto, Ontario, pereen 
M4H 1J) 






teeeecccees 


If you have interfaced KIM to the Southwest Technical Products G?-6144 Graphic Display (or 
if you are planning on doing 80) Stan Ockers, RR#, Box 209, Lockport, Ill. 60441, would like to 
exchange ideas with you. Stan says he has it up and running. 


Rene Vega, 4211 Avery, Detroit, Mich. 48208, had added some enhancements to Tiny Basic, 











Plana more, and wants to exchange thoughta with interested people. 
HORSERACE : rings fros 
Eight lap horse race and you can be the jockey and ten ores x. ten 

whip your horse to go faster. Warning-- whip the horse ° 19606 Gary Ave. 
too much and he probably poops out. Sunnyvale, Cal ’ 
Horse Track Whipping button 94086 
Prince Charming top PC 
Colorado Cowboy middle c 

* Irish Rair bottom 4 


Start program at 027F. Race is 8 laps. 
0270 XX XX XX XX XX XX XX XX XK XK XK XXAXK XXXL DB 
0280 a2 13 BD 7C 03 95 7C CA 10 FB A9 27F 8D 41 17 ao ’ 
0290 00 A2 09 B9 7C 00 9% FC 20 4E 1F CB CO 06 90 F3 
02A0 20 3D 1F A5 8F 3° E3 A2 03 CA 30 DE D6 86 DO FO 
08B0 46 99 A4 99 B6 83 Bg 90 03 35 7 BS BA EA EA EA 
02C0 95 7C E8 96 93 Bg FF 
02D0 30 38 DO 06 A5 AF FO 28 DO 30 A2 02 38 BS 83 E9 
02E0 06 95 83 CA 10 F6 A2 06 BS 7C 95 76 AD 80 95 7C 
O2FO CA DO F5 EA EA EA EA EA EA EA EA EA EA EA EA EA 
0300 C6 AF DO 06 A5 Bl 09 06, 85 81 EA EA EA EA EA EA 
0310 B9 39 00 FO OB 20 68 03 29 3c DO 1B 99 89 00 EA 
0320«20 68 03 29 38 85 9A B9 BC 00 30 OB 29 38 c5 9A 
0330 BO 05 A9 FF 99 939 00 20 3d 1F AO FF A6 99 3D 93 
0340 03 £0 01 98 98 55 39 85 9A EA EA 20 68 03 38 29 
0350 01 65 9A 19 A6 99 75 9C EA EA EA EA Ea EA EA EA 
DIGRX MEX RUX DEXRAXHRXAMX RX IRAAS XGRKM SX PEXOEXRAXR EXPT 
0360 95 8c 95 96 Ye a9 02 xx 33 A5 92 65 95 65 96 B5 
0370 91 A2 04 B5 91 95 92 CA lo F9 60 XX 80 80 80 80 
0320 80 30 90 FF FF FF 980 80 90 00 00 00 80 80 80 08 
0890 FE BF F? 01 02 0% H 
Thanks to Jim Butterfield for the original idea, my wife 
for the whipping suggestion, and Jim Batterfield, again, 
for the dispaay routine and random number generator. 


NOTE ON MOON LANDER 
Terrific program, but we were wondering why it sometimes 
slips into feul mode. it turns out this is from using the 


GETKEY subroutine in decimal-node. fhis routine sets 
the accumulator equal to 15 (Hex) if it finds no key pushed. 
But that's the decimal code for *F*, so under the condition 
that it brdthes into GETKEY because there is a key depressed, 
and the key is lifted before execution of the subroutine, 
MOONLANDER interprets the 15 default value as a depressed 

° "F* key. Easiest solution--change step 0092 to 14 and now 
‘E' (Energy) will be the button for fuel mode. 
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we been informed of two possiole 
CPU's di set the zero flag correctly a 
j This would « = :possible to run Ti! 


iroblem areas with tre 45° 

er register to register trans!ers,(Th 

c, All G5C2 CiUgcould have rrotierns seit: 
zero fiag after dettmgl addition vhen .iwer equalled zero. Test your “i th a exsple 
program to see af you these protless, The decimel addition problem can ce fatten around 

+ by an “OR" immediate with "™ fter the oseruticn wi:ck would then set the zero flag correctly. 
The only methcd <{ solving the re transfer rot setting zero flag would te to inetall a 
new CFU. (You would then pick up thi OR" rotate richt instruction in the process). 




















, Sopying KIM capsette tap. 
If you've tried copying KIM tapes from cassette cagsette then you already know that 
the copies will not be read correctly by KIM. The fix? ply tie a .02 uf capacitor to 


| ground from the jumetion of R6 and R34, Now make .the new ma: 
master should be read correctly by KIM, 


tape. Copies from thie new 










KlM-2 Memory expansion: 


If you wish your KIM-2 (4K) = 
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e >.3K pull-up resistor to +5 volts and tie these four 
the KIM-2, set atl the on-board DIP evitch 





ory sodule to reside in the O400-13FF position dy 

~ or the KIM KL, K2, K3, K4 decoder outputs together, add 
es to the addrese line 12 input on 
to the "off" position, and you're all set! 
































"TKODUCTION “C “IM-1 ARCHITECTURE J. Butterfield 
¥f 14 Brooklyn Avenue 
Toronto M4M 2X5 


Canada 


This is intended to be a beginner's guide to 

the way KIM-1 is put together. It's mostly a 
hardware description with (hopefully) explanatory 
notes. 





‘Because every KIM-1 owner has three fat manuals on 
his system, complete with detailed drawings, I'll 
try to save space here by referring to these manuals 
wherever possible. 


The Address and Data Busses. 


Let's start with page 24 of the KIM-1 User Manual 
(KIM-1 Block Diagram, Figure 3.1). We're going to 
concentrate on those two pipes on the lefts the 
Address and Data Busses. 


Every microsecond, the 6502 microprocessor sends out 

an address over the sixteen lines of the address bus. 
Sixteen lines are enough to address any of the 65,536 
memory locations that could be fitted to KIM-1 

(you only have 3,328 active addresses in the basic unit). 
In addition, there are a couple of other lines that 
accompany this bust a Read/Write line (R/W) to tell 
whether the microprocessor wants to read or write memory; 
and a timing line, é2 (phi, pronounced fy, two; it's 
confusing on the diagram because the phi looks like a zero). 


The address bus goes to all memories. The idea is 
that when an address is generated, one memory only 
(whether RAM, ROM, I/O or Timer) suddenly says, 
‘that’s mel" and connects to the data bus. 

If the R/W line says, 'read', the memory concerned 
Places its data onto the bus; if ‘write’, the 

memory takes the data from the bus (placed there by 
the microprocessor) and stores it. For every address, 
only one memory unit responds; the rest stay silent. 


This points out a fundamental difference between the 
address and data busses. The address bus goes one way 
only: from the processor to the memory. But the data 
bus information flows both ways. 


‘nis calls for a special kind of circuitry to connect 

o the data bus, called ‘tri-state'. Every device on 

he bus might be (1) sending; (2) receiving; or, 

3) ignoring the bus. (That isn't exactly how tri-state 
s defined, but it's a good way to remember it). La 
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